Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Movie Posters and Movie Previews

GetPosterBox

The GetPosterBox function allows you to obtain a poster's boundary rectangle.

pascal void GetPosterBox (Movie theMovie, Rect *boxRect);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

boxRect

Contains a pointer to a rectangle. The Movie Toolbox returns the poster's boundary rectangle into the structure referred to by this parameter.

DESCRIPTION

When you call GetPosterBox without having called SetPosterBox, the current movie matrix is applied to the poster tracks to determine the poster box.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You set the poster's boundary rectangle by calling the SetPosterBox function, which is described in the previous section.